home *** CD-ROM | disk | FTP | other *** search
/ Ian & Stuart's Australian Mac 1993 September / clonecd / September 93.img / Australasian Legends / Commercial / Golden Micro Solutions / Commander Demo / Commander Demo.rsrc / TEXT_5025_ARRAY STRING.txt < prev    next >
Text File  |  1993-09-07  |  2KB  |  41 lines
  1. ARRAY¬†STRING (string length; name; size1; {size2})
  2.                                                                                     Pg 13-2
  3.  
  4. string length     Number    Length of the strings
  5. name                Array      Name of the array to create
  6. size1                Number    Number of elements in the array or number 
  7.                                              of rows if size2 is specified
  8. size2                Number    Number of columns in a two dimensional array
  9.  
  10.  
  11. Creates name, an array of type Integer, with size1 number of elements. Each element can hold string length characters. If specified, name will be a two-dimensional array with size1 columns and size2 rows. If name already exists, the array is resized and elements that are not cropped retain their value.
  12.  
  13. The size2 parameter is optional; if it is specified the commands create two-dimensional arrays. In this case, size1 specifies the number of rows and size2 specifies the number of columns in each array.
  14.  
  15. Each row in a two-dimensional array can be treated like an element.This means that you can insert and delete entire arrays in a two-dimensional array with the other array commands.
  16.  
  17.  
  18. The string length parameter is specified only for string arrays. It specifies the number of characters that each array element in a string array can contain. generally operations performes on a string array are faster than operations performed on a text array.
  19.  
  20. An element 0 (array name{0}) is always created for an array, and is set to a null value of the array type. Use the Size¬†of¬†array command to find the size of the array. the following line would delete all elements (except the 0 element), but leave the array defined:
  21.  
  22.       ARRAY¬†STRING (255;‚óäMine;0)
  23.  
  24. The following formula shows how to calculate the amount of memory used by a string array:
  25.  
  26.     2+(1+number of elements)*Declared length defined for the elements 
  27.                                                       (+1 if odd; +2 if even)
  28.  
  29. Note: a few more bytes may be required to keep track of the selected element, the number of elements, and the array itself.
  30.  
  31.  
  32. When an array is first created, its elements are empty values: "".
  33.  
  34. You refer to the elements by using curly braces. For example, MyArray{2} refers to the second element in the array MyArray. For two-dimensional arrays you refer to individual elements by using two sets of curly braces. For example, MyArray{3}{5} refers to the third row and fifth column.
  35.  
  36.  
  37.  
  38. See also:  Size¬†of¬†array 
  39.  
  40.  
  41.